---
title: Letter request generation
summary: Retrieve and enrich legal letter requests for Xpressions output.
status: draft
owner: SAIF Documentation Generator
last_reviewed: 2026-08-26
library: SAIF.Business.Claim.Legal
reference_type: embedded
operation_id: letter-request-generation
trigger: A letter print job requests one or more legal letter requests
---

# Letter request generation

Retrieves a legal letter request, resolves its legal-case number, and produces the Xpressions XML
payload used to render and print the letter.

| Field | Value |
| --- | --- |
| **Operation ID** | letter-request-generation |
| **Trigger** | Letter print job |
| **Inputs** | Letter type, claim number |
| **Outputs** | Xpressions XML payload, printed date |
| **Primary components** | `clsLetterRequest.GetReportXmlNewFormat`, `clsLetterRequest.GetLegalCaseNumber`, `clsLetterRequest.PostFill` |
| **Entry point** | `SAIF.Business.Claim.Legal\Print\clsLetterRequest.vb` |

## Steps

1. `GetLegalCaseNumber()` resolves the legal case number associated with the letter request.
2. `PostFill()` runs after the request row is loaded to complete any additional field population.
3. `GetReportXmlNewFormat(packageName, ...)` builds the Xpressions XML payload for the requested
   letter package.
4. The letter is printed and its printed date is recorded on the request.

## Process flow

```mermaid
flowchart TD
	Start(["Letter print job<br>requests letter"]) --> Load["Load letter request<br>and PostFill"]
	Load --> CaseNum["GetLegalCaseNumber"]
	CaseNum --> Xml["GetReportXmlNewFormat<br>builds Xpressions XML"]
	Xml --> Print["Letter printed"]
	Print --> EndOk(["Printed date<br>recorded"])
```

## Failure and edge-case behavior
- No exceptional behavior beyond standard retrieve/save failure handling was identified for this
  operation.*

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Database tables](../database-tables.md)
- [SQL catalog](../sql/index.md)

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts.

## Sources
- `SAIF.Business.Claim.Legal\Print\clsLetterRequest.vb`